home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / editors / hexedit / he.doc < prev    next >
Text File  |  1996-07-10  |  21KB  |  428 lines
  1.  
  2.  
  3.  
  4.                                                                 6-07-94
  5.                                  HexEdit rev 1.3
  6.  
  7.         TABLE OF CONTENTS
  8.  
  9.         1. INTRODUCTION
  10.                 System Requirement                                      3
  11.                 File Size Restrictions                                  3
  12.                 What You Need to Know                                   3
  13.  
  14.         2. GETTING STARTED
  15.                 Backing Up HexEdit                                      3
  16.                 Installing Onto A Hard Disk                             4
  17.                 Running HexEdit                                         4
  18.  
  19.         3. FEATURES
  20.                 Getting Help                                            4
  21.                 Menus                                                   4
  22.                 Entering Bytes                                          5
  23.                 Cursor Movement                                         5
  24.                 Function Keys                                           5
  25.                         F1 - Help                                       5
  26.                         F2 - File Menu                                  5
  27.                                 Save file                               5
  28.                                 Save and name file                      5
  29.                                 Save file and exit                      5
  30.                                 Insert file                             5
  31.                                 Write block to file                     5
  32.                                 Quit, abandon edits                     5
  33.                         F3 - Edit Menu                                  5
  34.                                 Delete byte                             5
  35.                                 Delete block                            5
  36.                                 Begin block mark                        5
  37.                                 End block mark                          5
  38.                                 Clear block marks                       5
  39.                                 Copy block                              5
  40.                                 Move block                              5
  41.                                 Toggle overtype/insert mode             5
  42.                                 Toggle hex/character mode               6
  43.                                 ASCII character set window              6
  44.                         F4 - Goto Menu                                  6
  45.                                 Go to address                           6
  46.                                 Find byte string                        6
  47.                                 Previous page                           6
  48.                                 Next page                               6
  49.                                 Beginning of file                       6
  50.                                 End of file                             6
  51.                         F5 - DOS Command                                6
  52.                 Alt Keys                                                6
  53.                         Alt+a   ASCII character set window              6
  54.                         Alt+b   Begin block mark                        6
  55.                         Alt+c   Copy block                              6
  56.                         Alt+d   Delete block                            7
  57.                         Alt+e   End block mark                          7
  58.                         Alt+f   Find byte string                        7
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.                         Alt+g   Go to address                           7
  66.                         Alt+h   Toggle hex/character mode               7
  67.                         Alt+i   Insert file                             7
  68.                         Alt+m   Move block                              7
  69.                         Alt+n   Save and name file                      7
  70.                         Alt+q   Quit, abandon edits                     7
  71.                         Alt+r   Clear block marks                       7
  72.                         Alt+s   Save file                               7
  73.                         Alt+w   Write block to file                     7
  74.                         Alt+x   Save file and exit                      7
  75.                 Special Keys                                            7
  76.                         BS                                              7
  77.                         Del                                             7
  78.                         End                                             7
  79.                         Enter                                           7
  80.                         Esc                                             7
  81.                         Home                                            7
  82.                         Ins                                             7
  83.                         PgDn                                            7
  84.                         PgUp                                            7
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                         2
  123.  
  124.  
  125.  
  126.         INTRODUCTION
  127.  
  128.         Thank you using HexEdit.  HexEdit is an easy-to-use binary or text
  129.         file editor containing both hex byte and text editing features.
  130.         With most text editors, non-printable characters are not displayed
  131.         on the screen and editing these non-printable characters are
  132.         difficult if not impossible.  HexEdit displays all bytes within a
  133.         file(including non-printable characters) and provide powerful byte
  134.         editing features for the serious user.
  135.  
  136.         A character mode is available for quickly typing in characters rather
  137.         than editing bytes.  An ASCII character set window is also available
  138.         for viewing or entering characters from the window.
  139.  
  140.         1. System Requirements for HexEdit
  141.                 HexEdit requires an IBM XT,AT,PS1,PS2,Tandy,386,486,Pentium
  142.                 or 100% compatible with 640K RAM.
  143.  
  144.         2. File Size Restrictions
  145.                 Because the HexEdit file being edited is fully loaded into
  146.                 RAM(fast editing), file sizes are restricted by the amount
  147.                 of available RAM.  The default maximum file size is 262,144
  148.                 bytes.  Editing files larger than 262,144 is possible if
  149.                 enough conventional RAM memory is available on your system.
  150.                 Removing TSR's loaded into conventional memory will increase
  151.                 RAM.  See "3. Running HexEdit" below for more information on
  152.                 editing files larger than 262,144 bytes.
  153.  
  154.         3. What You Need to Know
  155.                 HexEdit was designed for the computer user who requires to view
  156.                 or edit bytes within a file.  I assume that you know how to
  157.                 turn on your computer and run DOS.  Review the manuals that
  158.                 came with your computer if you are unfamiliar with it.
  159.  
  160.                 Terms You Need To Know
  161.                         Default is a setting which is initially set when
  162.                         HexEdit is first used.  For example, when you run
  163.                         HexEdit, it assumes that you with start your editing
  164.                         in overtype mode and hex mode.
  165.  
  166.                         Toggle is a feature which switched the settings to the
  167.                         next possible choice.  For example, if you are in
  168.                         overtype mode and wish to change to insert mode,
  169.                         pressing the INS key will toggle the mode to insert
  170.                         mode.  Pressing INS again will toggle you back to
  171.                         overtype mode.
  172.  
  173.  
  174.         GETTING STARTED
  175.  
  176.         1. Backing Up HexEdit
  177.                 Before you begin using HexEdit, you should make a back-up copy
  178.                 of the program to another disk and on your hard disk. Back-ups
  179.                 save time and problems if something should ever happen to your
  180.                 original HexEdit program.  Refer to the DOS manual that came
  181.  
  182.  
  183.                                         3
  184.  
  185.  
  186.  
  187.                 with your computer if you are unfamiliar with COPY or DISKCOPY.
  188.  
  189.         2. Installing Onto You Hard Disk
  190.                 HexEdit is completely contained on a single file.  Just copy
  191.                 HE.EXE into any directory within your path or make a new
  192.                 directory.  HexEdit requires no hardware set-up.
  193.  
  194.         3. Running HexEdit
  195.                 There are three different ways to run HexEdit.
  196.  
  197.                 A. Running HexEdit without a file:
  198.                         Type HE and press Enter.  A file called NO_NAME.HEX
  199.                         will be created with no bytes.  When editing is
  200.                         complete, you can press Alt+n to save and name file.
  201.  
  202.                 B. Running HexEdit with a file:
  203.                         Type HE FILENAME and press Enter.  FILENAME is the name
  204.                         of the file for editing.
  205.  
  206.                 C. Running HexEdit with a file and changing its file
  207.                    allocation size.
  208.  
  209.                         Type HE FILENAME ALLOCATION_SPACE and press Enter.
  210.                         Examples:  HE FILENAME.HEX 100000
  211.                                    HE FILENAME.HEX 350000
  212.                         FILENAME is the name of the file for editing.
  213.                         ALLOCATION_SPACE is a decimal number which specifies
  214.                         the amount of 640K RAM necessary to edit FILENAME.
  215.  
  216.                         This method of running HexEdit should be avoided unless
  217.                         memory allocation errors occur.  The default allocation
  218.                         size used to load a file into HexEdit is 262,144 bytes.
  219.                         Files larger than 262,144 bytes will require more
  220.                         allocation space.  The amount of space which cam be
  221.                         allocated is dependent on the amount of 640K RAM still
  222.                         available on your system AFTER loading HexEdit.
  223.  
  224.  
  225.         FEATURES
  226.  
  227.         1. Getting Help
  228.                 When you start HexEdit, a main menu appears with a choice for
  229.                 Help.  While in the editor, press the F1 key to display the
  230.                 help screen.
  231.  
  232.         2. Menus
  233.                 HexEdit uses pop-up menus that offer a set of choices or option
  234.                 in an organized manner.  When you first run HexEdit, you will
  235.                 drop directly into the Main Menu.  A menu option will be
  236.                 highlighted.  Press Enter to select the highlighted choice.  To
  237.                 select a different option, use the arrow keys to highlight your
  238.                 choice and press Enter or press the highlighted character.
  239.  
  240.                 While a menu is open in the editor, the left or right arrow
  241.                 keys can be used to open adjacent menus.  Press the ESC key
  242.  
  243.  
  244.                                         4
  245.  
  246.  
  247.  
  248.                 to cancel a menu.
  249.  
  250.         3. Entering Bytes
  251.                 In the upper-right corner of the editor screen, a working area
  252.                 appears for editing the present address location.  In overtype
  253.                 mode, the byte of the present address will appear in this
  254.                 working area.  In insert mode, this working area will appear as
  255.                 dashes until data is typed in.  Once the change is completed,
  256.                 press Enter to load the change into the editor.
  257.  
  258.         4. Cursor Movement
  259.                 Cursor movement within the editor is done by moving the Arrow
  260.                 keys, HOME, END, PgUp or PgDn key.  To move the cursor to a
  261.                 specific address location, use Alt+G (Go To Address).  Alt+F
  262.                 (Find Byte String) will also move the cursor to the next
  263.                 address containing the specified byte string.
  264.  
  265.         5. Function Keys
  266.                 These five special function keys are displayed on the top
  267.                 menu of the editor screen.
  268.  
  269.                 F1 - Help
  270.                 The help screen displays all the key and key combinations.
  271.  
  272.                 F2 - File Menu
  273.                 List various choices related to file operation.
  274.  
  275.                 Save file - Saves contents of editor under the current file
  276.                         name and resumes editing.
  277.                 Save and name file - Requests a new file name, saves the
  278.                         contents of editor and resumes editing.
  279.                 Save file and exit - Saves contents of editor and returns to
  280.                         main menu.
  281.                 Insert file - Insert a file starting at the current address
  282.                         location.
  283.                 Write block to file - Requests a file name and saves bytes
  284.                         within block marks.
  285.                 Quit, abandon edits - Returns to main menu without saving
  286.                         changes to file.
  287.  
  288.                 F3 - Edit Menu
  289.                 List various choices related to editing operation.
  290.  
  291.                 Delete byte - Deletes byte in the current address location.
  292.                 Delete block - Deletes bytes located within the block marks.
  293.                 Begin block mark - Marks the current location as the beginning
  294.                         of the block.
  295.                 End block mark - Marks the current location as the end of the
  296.                         block.
  297.                 Clear block marks - Remove block marks.
  298.                 Copy block - Copies the bytes within the block marks to the
  299.                         current address location.
  300.                 Move block - Moves the bytes within the block to the current
  301.                         address location.
  302.                 Toggle overtype/insert mode - Changes the mode from which bytes
  303.  
  304.  
  305.                                         5
  306.  
  307.  
  308.  
  309.                         are loaded into the editor.  Overtype mode (default
  310.                         mode) overwrites the contents of the byte in the
  311.                         current address location.  Insert mode will push all
  312.                         bytes equal to or greater than the current address
  313.                         location and insert the byte, block or file into the
  314.                         current address location.
  315.                 Toggle hex/character mode - Allows the user to edit characters
  316.                         instead of bytes.  Hex mode (default mode) allows the
  317.                         user to edit bytes.  Character mode allows the user to
  318.                         change bytes by typing characters.  Only printable
  319.                         ASCII characters may be used.  Printable is ASCII
  320.                         21h - 7Fh.
  321.                 ASCII character set - Use the ASCII character set window Alt+a
  322.                         for viewing or entering printable or non-printable
  323.                         characters.  Press the ESC key to remove the window.
  324.  
  325.                 F4 - Goto Menu
  326.                 List various choices related to moving the current address
  327.                 location.
  328.  
  329.                 Go to address - Move to the specified hex address location.
  330.                 Find byte string - Find the specified byte string.  Use the
  331.                         arrow keys to move to the next byte or previous bytes.
  332.                         Press Enter to begin search.  Alt+a can be used to
  333.                         enter characters.  The search begins at the present
  334.                         address location.
  335.                 Previous page - Move to the previous address screen.
  336.                 Next page - Move to the next address screen.
  337.                 Beginning of file - Go to the first address location.
  338.                 End of file - Go to the last address location.
  339.  
  340.                 F5 - DOS Command
  341.                 Allows the user to execute a DOS command.
  342.                 For example, if you want to insert a file into the editor but
  343.                 can't remember the file name, press F5.  Type DIR and press
  344.                 Enter.  Files in the current directory are displayed.  Press
  345.                 any key to return to editing.
  346.  
  347.         6. Alt Keys
  348.                 Allows the user to run task quickly rather than sifting through
  349.                 the menus on the top of the editor screen.
  350.  
  351.                 The Alt key is designed to be used in combination with another
  352.                 key to run the specified task.  For example, to use the ASCII
  353.                 character set window, hold down the Alt key and press the
  354.                 letter A.  The ASCII character set window appears on the
  355.                 screen.
  356.  
  357.                 Alt+a   ASCII character set window - Allows the user to view or
  358.                         enter an ASCII character into the editor.  Use arrow
  359.                         keys to select character within window and press Enter
  360.                         or press the ESC key to remove the window.
  361.                 Alt+b   Begin block mark - Marks the current address location
  362.                         as the beginning of the block.
  363.                 Alt+c   Copy block - Copies the bytes within the block marks to
  364.  
  365.  
  366.                                         6
  367.  
  368.  
  369.  
  370.                         the current address location.
  371.                 Alt+d   Delete block - Deletes bytes located within the block
  372.                         marks.
  373.                 Alt+e   End block mark - Marks the current location as the end
  374.                         of the block.
  375.                 Alt+f   Find byte string - Find the specified byte string.
  376.                         Use the arrow keys to move to the next byte or previous
  377.                         bytes, then press Enter to begin search.  Alt+a can be
  378.                         used to enter characters.  The search begins at the
  379.                         present address location.
  380.                 Alt+g   Go to address - Move to the specified address.
  381.                 Alt+h   Toggle hex/character mode - Allows the user to edit
  382.                         characters instead of bytes.  Hex mode (default mode)
  383.                         allows the user to edit bytes.  Character mode allows
  384.                         the user to change bytes by typing characters.  Only
  385.                         printable ASCII characters can be used.  Printable is
  386.                         ASCII 21h - 7Fh.
  387.                 Alt+i   Insert file - Insert a file starting at the current
  388.                         address location.
  389.                 Alt+m   Move block - Moves the bytes within the block marks to
  390.                         the current address location.
  391.                 Alt+n   Save and name file - Requests a new file name, saves
  392.                         the contents of editor and resumes editing.
  393.                 Alt+q   Quit, abandon edits - Return to main menu without
  394.                         saving changes.
  395.                 Alt+r   Clear block marks - Remove block marks.
  396.                 Alt+s   Save file - Save contents of editor under current file
  397.                         name and resumes editing.
  398.                 Alt+w   Write block to file - Requests a file name and saves
  399.                         bytes within block marks.
  400.                 Alt+x   Save file and exit - Save contents of edit under
  401.                         current file name and return to main menu.
  402.  
  403.         7. Special Keys
  404.                 BS      Use backspace to delete the previous character.
  405.                 Del     Deletes the byte or character, depending on mode in
  406.                         use.
  407.                 End     Go to the last address location.
  408.                 Enter   Used to enter a byte, string or choice from a menu.
  409.                 Esc     Cancels menus or windows.
  410.                 Home    Go to the first address location.
  411.                 Ins     Changes the mode in which bytes are loaded into the
  412.                         editor.  Overtype mode (default mode) overwrites the
  413.                         contents of the byte in the current address location.
  414.                         Insert mode will push all bytes equal to or greater
  415.                         than the current address location and insert the byte,
  416.                         block or file into the current address location.
  417.                 PgDn    Move to the next address screen.
  418.                 PgUp    Move to the previous address screen.
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                                         7
  428.